home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / sfcb12.zip / SFCB.ZIP / SFCB.DOC < prev    next >
Text File  |  1992-03-09  |  37KB  |  685 lines

  1.                   -------------------------------------------
  2.                     ---------------------------------------
  3.                       -----------------------------------
  4.                                    SFCB 1.2
  5.                      SPITFIRE Call-Back Validation Utility
  6.                               Copyright (C) 1992
  7.                                Richard Sleegers
  8.                                -----------------
  9.                                RainbowSoft Wares
  10.                                     R.R. #8
  11.                             London, Ontario, CANADA
  12.                                     N6A 4C3
  13.                                -----------------
  14.                                   Rainbow BBS
  15.                             Sysop: Richard Sleegers
  16.                           Public Node: (519)455-4880
  17.                                 1200/2400 Baud
  18.                                -----------------
  19.                               Alternate contact:
  20.                              Spitfire Support BBS
  21.                          Buffalo Creek - 515-225-8496
  22.                                 1200-38400 baud
  23.                       -----------------------------------
  24.                     ---------------------------------------
  25.                   -------------------------------------------
  26.  
  27.                                        
  28.                               Table of Contents
  29.  
  30.  
  31. IN THE BEGINNING . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  32.  
  33. INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  34.       SFCB Batch Files File (SF.BAT) . . . . . . . . . . . . . . . . . . .   5
  35.       Spitfire Door Menus (SFDOOR.MNU, etc). . . . . . . . . . . . . . . .   6
  36.  
  37. COMMAND LINE PARAMETERS. . . . . . . . . . . . . . . . . . . . . . . . . .   6
  38.  
  39. EXECUTION. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  40.  
  41. FUNCTION KEYS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  42.  
  43. CONFIGURABLE OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  44.  
  45. SUPPORT FILES. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  46.  
  47. WARNINGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  48.  
  49. DISCLAIMER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  50.  
  51. SHAREWARE INFORMATION. . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  52.  
  53. TRADEMARKS, COPYRIGHTS . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  54.  
  55. SFCB HALL OF FAME! . . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  56.  
  57. FUTURE MODIFICATIONS . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  58.  
  59. MODIFICATION HISTORY . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  60.  
  61. COMMON QUESTIONS AND ANSWERS . . . . . . . . . . . . . . . . . . . . . . .  17
  62.  
  63.  
  64. INTRODUCTION
  65.  
  66.       Are you one of those sysops who is concerned about the quality of users
  67. on your BBS?  One time-consuming task for you is likely the validation of new
  68. users.  In order to prevent abuse, you expect that your users provide accurate
  69. and truthful information.  One of these tidbits of information is the phone
  70. number of the user, a way to contact them in case of a problem, or to help, or
  71. simply to verify that they are, indeed, providing truthful information. Prior
  72. to writing this program, I had to manually contact each new user by voice to
  73. validate him or her; a time consuming task, considering people like to call
  74. your BBS 24 hours a day, and you are not awake for 24 hours, watching your
  75. monitor.  (It's more like 23 hours a day, right?).  Now, while SFCB has been
  76. written to add security to your BBS, it is not a complete security system by
  77. any means, it merely acts on the assumption that most users are truthful and
  78. not malicious.  You, as the sysop are ultimately responsible for the actions
  79. of your users!
  80.  
  81.       SFCB allows a user to validate him/herself by entering a door or menu
  82. option.  The program will call back, using the number provided through the new
  83. user log-on.  Upon successful re-connection and data verification (name,
  84. password and optionally, the birth-date), the user's security level will be
  85. upgraded to that of your BBS's regular user status (selectable by the sysop.)
  86.  
  87.       Other features of the program will be explained in this document, as
  88. well as some of the necessary Shareware information and disclaimers (yes,
  89. there are some!)  I chose to put them at the END of the document, so you can
  90. worry about the guidelines if indeed you have tried out this program and found
  91. it useful.  Quickly, though, here are some of the important legalities:
  92.  
  93.       SFCB is distributed as Shareware, you may try it out for a period of 14
  94. to 21 days, after which time you must register it or remove it from your
  95. system.
  96.       There are no warranties or guarantees with SFCB.
  97.       You may distribute SFCB, on the condition that you do not alter the
  98. package, or any of the file's contents, or receive financial compensation for
  99. it, other than regular BBS fees.
  100.       For more information, please refer to the sections entitled DISCLAIMER
  101. and SHAREWARE INFORMATION.
  102.  
  103.       Now on with the important stuff!
  104.  
  105. IN THE BEGINNING
  106.  
  107.       SPITFIRE was born under the direction of Mike Woltz, of Buffalo Creek
  108. Software, to fill a unique position in the  communications world.  Many users
  109. and potential sysops (myself included) were drawn to the software for the same
  110. reason Mr. Woltz wrote it.  Of course, we all have our own ideas for
  111. making it better and enhancing it, and this is my contribution.
  112.  
  113.       This version of SFCB has been written to reflect the multi-node version
  114. 3.0/3.1 of SPITFIRE and is backwards compatible with version 2.8.  It is my
  115. intention to update the program for future versions at no cost to registered
  116. users (sans telephone calls to obtain it).  If you require compatibility with
  117. an earlier version, please send correspondence to me and I will see about
  118. making one available for your version.  I will also consider writing versions
  119. compatible with BBS systems other than Spitfire.
  120.  
  121. INSTALLATION
  122.  
  123.       SFCB comes with an install batch file which will work for first time
  124. installation as well as updates from previous versions.  (You will need about
  125. 400K free disk space and 300K free RAM memory to run install automatically -
  126. it is suggested that you exit Spitfire instead of dropping to DOS)
  127.  
  128.       Extract the SFCB compressed file (SFCBxx.ZIP) - where 'xx' is the
  129. current version - to a new directory and run INSTALL.BAT from the new
  130. directory.  For example
  131.  
  132. MD \TEMPSFCB
  133. PKUNZIP SFCB12.ZIP \TEMPSFCB
  134. CD \TEMPSFCB
  135. INSTALL C:\SF\SFCB
  136.  
  137. Once the program is installed, you may remove the \TEMPSFCB directory and its
  138. contents..
  139.  
  140. CD \
  141. DEL TEMPSFCB
  142. RD TEMPSFCB
  143.  
  144.       To install SFCB manually, create a directory for SFCB, and then move or
  145. uncompress all of the support files into this directory.  In this example I
  146. will use C:\SF\SFCB for the door directory.
  147.  
  148.       SFCB Batch Files File (SF.BAT)
  149.  
  150.       Next you must include in your SF.BAT file the necessary steps to execute
  151. the call back program.  In this example, SFCB is installed as  Door C.
  152.  
  153. *** This is the recommended method *** but, if you prefer:
  154. SF.BAT:
  155.       :DOOR_C
  156.             CD C:\SF\SFCB
  157.             SFCB -D C:\SF
  158.             CD ..
  159.       GOTO LOOP
  160.  
  161.  
  162. SF.BAT:
  163.       :DOOR_C
  164.             COPY C:\SF\SFDOORS.DAT C:\SF\SFCB
  165.             CD C:\SF\SFCB
  166.             SFCB
  167.             COPY C:\SF\SFCB\SFDOORS.DAT C:\SF
  168.             CD ..
  169.       GOTO LOOP
  170.  
  171.       Spitfire Door Menus (SFDOOR.MNU, etc)
  172.  
  173. If you run SFCB as a door, than you need a line in the corresponding
  174. SFDOOR.MNU file, eg:
  175. Call-Back Verification,5
  176.  
  177. The installation program will attempt to correctly install SFCB if you are
  178. running it as a door or as a main menu extension.  Please take a few moments
  179. to verify it is done correctly and to your liking, this will save you time
  180. later.
  181.  
  182. See your SPITFIRE manual for more details on installing door programs, or if
  183. you are running SFCB as a menu extension.
  184.  
  185. Once SFCB is setup in the batch and menu files, you must configure SFCB with
  186. the SFCBINST.EXE program.  Help is contained in the program to explain all of
  187. the options.
  188.  
  189. COMMAND LINE PARAMETERS
  190.  
  191.       If you wish, you may use the command line options to specify where to
  192. find the door file, configuration file, or to override the comm port or baud
  193. rate (now why would you WANT to do that?)
  194.  
  195.       Here are the available command line parameters:
  196.  
  197. -D C:\SF\SFDOORS.DAT    Where to find the door file.
  198. -D C:\SF\SFMAIN.DAT     You may run SFCB as an extension, simply place the
  199.                         necessary commands in your SFMAIN.BAT, SFMESS.BAT or
  200.                         SFFILE.BAT, for more information on this method,
  201.                         please consult your Spitfire Manual. Depending on your
  202.                         version of Spitfire, this may or may not work, version
  203.                         2.8 and above will read the corresponding data file
  204.                         and update the security level.
  205. -R                Reconnect delay after CONNECTion is re-established.  Default
  206.                   is 6 seconds.
  207. -W                Wait time before redialing.  Default is 6 seconds.
  208. -B 1200           Change the baud rate to 1200.  (You really should let SFCB
  209.                   determine the baud rate from the SF Data file)
  210. -P 1              Use Comm Port 1.  (Again, SFDOORS.DAT contains the port the
  211.                   user logged in at.)
  212. @R                Disable Opening Shareware screen - available to registered
  213.                   users only.
  214. -C [filename]     Option used in previous versions of SFCB (1.1 and older). 
  215.                   Remove this option from existing batch files.  When updating
  216.                   from previous versions, this file will be converted to the
  217.                   new format  and will no longer be used.
  218.  
  219. EXECUTION
  220.  
  221.       In the event that there are problems with the successful installation of
  222. the SFCB program, please refer to  the comments shown to you on the screen and
  223. in the log file (SFCB.LOG)  You will be informed if SFCB cannot find the door
  224. data file or if it has not been installed.  When all goes well, you will see
  225. the initial log-on screen(CBOPEN.BBS), then the program 'plug', stating the
  226. current version and registration information; the usual stuff.
  227.  
  228.       The initial log-on screen should contain the necessary information to
  229. introduce the purpose of the program to the user and the process that it
  230. involves.  This opening file may also be displayed in ANSI by creating an ANSI
  231. corresponding file named CBOPEN.CLR.  This file will be displayed if the user
  232. has logged on to SPITFIRE with ANSI activated.  (ANSI.SYS does not have to be
  233. loaded to see ANSI correctly on the BBS computer while within SFCB.
  234.       The user is presented with the current settings, and the SFCB Main Menu. 
  235. The menu shows the user's phone number and terminal program (which must be
  236. selected)  When all is ready, option "C" (call-back) is activated and the user
  237. can continue call-back.
  238.       SFCB will attempt to determine whether the caller is long-distance from
  239. the BBS.  Numbers that are not the same area code are assumed long distance
  240. and will not be validated unless the sysop allows long-distance validation. 
  241. If a number is within the sysop's area code, but not considered a local
  242. exchange (by comparing it to the numbers in the SFCB.XCH file),  SFCB will ask
  243. if the user's number is long-distance.  If the number is not local and the
  244. user informs SFCB it is, no validation will be made, as the phone call will
  245. not successfully reach the intended person.
  246.       After checking security levels and phone numbers, SFCB hangs up and
  247. attempts to call the user back.  It will attempt as many times as you have
  248. configured.  Here is where you must have your Tone/Pulse set correctly.  If
  249. you cannot dial with Tone, make sure you set the Tone available option to
  250. False.  After the connection is re-established, (and CONNECT.BBS/CLR
  251. displayed) the user will be prompted for his or her name and password.  You
  252. may force the user to enter his/her birth date as well, and/or a random code
  253. displayed prior to hangup.  When all is entered correct (case is NOT
  254. significant for the password entered) then the final file, CBCLOSE.BBS/CLR
  255. will be displayed, explaining what the new security level entails, or whatever
  256. else the user must do for complete validation, etc., depending on your BBS
  257. setup.
  258.       You will be able to see at all times where the user is currently at in
  259. the program, and can "help" the user along in case of difficulty.  Also
  260. displayed on the top portion of the screen is the user name, baud rate,
  261. security level and time left.  Press F1 or Home to display the available
  262. function keys.
  263.       Once a user is in the program, you may chat by pressing ALT-C.  Pressing
  264. ALT-C again will to exit the chat.  Likewise, you may Drop to DOS if need be
  265. by pressing ALT-J (provided that you have enough memory).  To exit back to
  266. SFCB after a drop to DOS, type "EXIT".
  267.  
  268.       SFCB will provide users with sysop level or greater an additional menu,
  269. which can be used to display the log and validation files. (SFCB.LOG,
  270. SFCB.VAL, SFCB.NVL)
  271.  
  272. FUNCTION KEYS
  273.  
  274.       Here is a list of keys available to the sysop.  (They cannot be used by
  275. the caller.)  Press F1 or HOME to display these keys while running the
  276. program.
  277.  
  278. Chat mode         Alt C             Press Alt C to end chat.
  279. Drop to DOS       Alt D, Alt J      Local drop to dos only.
  280. Add time          F7                Adds 5 minutes to user's time
  281. Subtract time     F6                Subtract 5 minutes
  282. Twit user         Alt F2      No sysop can be without a user terminate
  283.                               function. :)  Twit will hang up the modem line,
  284.                               or end a local mode test.
  285.  
  286. CONFIGURABLE OPTIONS
  287.  
  288.       Options are modified via the SFCBINST.EXE program.  This program should
  289. live in the same directory as your SFCB.EXE file.  If you are compressing SFCB
  290. with a program such as LZEXE or PKLITE you must decompress it first before you
  291. can configure the program.
  292.       The options are pretty straight-forward and are briefly explained within
  293. SFCBINST.  A few should be commented on, and they follow:
  294.  
  295. Sysop security level    This need not be the sysop security (normally 999) but
  296.                         can be any level which you wish to have access to the
  297.                         log files.
  298. [LD] Validation times   The method for disabling call-back at any time of the
  299.                         day (limited to 1/2 hour intervals is to place a BLANK
  300.                         in the position in the chart where you do NOT want to
  301.                         allow call-backs.  (The chart starts and 12:00
  302.                         midnight, so the first 'x' would correspond to the
  303.                         time period 00:00-00:29 or 12:00-12:29am) You may find
  304.                         this helpful if you are allowing long-distance
  305.                         call-backs and you do not wish to have calls during
  306.                         prime time (save those Long Distance bills for calling
  307.                         other BBS'!)
  308. Low baud rate           This feature is used when a long distance call has
  309.                         successfully completed.  If you wish users to be
  310.                         logged off immediately after entering his/her name and
  311.                         password, place a '-1' (minus one) here.  To allow all
  312.                         callers to remain on-line (why would you want to run
  313.                         up those LD bills??) place a '0' (zero) here.  Any
  314.                         other number will act as the cutoff point.  If you
  315.                         place 9600 here, than any caller below 9600 baud will
  316.                         be disconnected, and those 9600 and higher will be
  317.                         permitted to remain on-line, at your expense.
  318. BBS area code           This number is essential to determining whether a call
  319.                         is long-distance or not.  Place the first 3 digits of
  320.                         your whole BBS number here.  The location of your BBS
  321.                         is necessary to ask the caller whether a number in the
  322.                         same area code is still long-distance.  To make it
  323.                         easier on the users, each time a new exchange code is
  324.                         entered and validated, add it to the SFCB.XCH file. 
  325.                         Then the user is no longer prompted if they are long
  326.                         distance when the number is located.
  327. Force birth date        When enabled (True) this option will only validate the
  328.                         user if he/she also enters the correct birth date
  329.                         along with name and password.  Please note that if you
  330.                         do not have the "Require New User Birth Date" option
  331.                         in the Alt T (Toggles) menu of SPITFIRE set to YES,
  332.                         than this option will not work properly since there
  333.                         will not be an accurate date setting for each user.
  334. Allow number change     When enabled, the user can change phone their number
  335.                         in SFCB.  Both old and new numbers will be logged to
  336.                         the log file.  If disabled, then the user is required
  337.                         to exit to Spitfire to change his/her number.  Due to
  338.                         the way SF reloads, this phone number will not be
  339.                         saved to the user file.  It will be remembered for the
  340.                         next call attempt if the user fails the first set of
  341.                         tries and uses the program next.
  342. Allow duplicates        When disabled (False), SFCB will search the
  343.                         SFUSERS.DAT file for a duplicate of the current user's
  344.                         phone number.  If you enable the previous setting
  345.                         (allow number change) the new number entered will be
  346.                         used to scan the user's phone numbers.  To prevent a
  347.                         user from putting a phoney (no pun intended :) number
  348.                         in SPITFIRE and using the real number within SFCB, you
  349.                         should resort to using the SFCB.BAD file to prevent
  350.                         problem numbers from being used.
  351. SUPPORT FILES
  352.  
  353.       There are a few files that SFCB searches for which you can use to lock
  354. out phone numbers or pre-verify users, and others which will be created by
  355. SFCB.  They are described here.  All files are in DOS text format and any
  356. commands are listed once per line..Please see the example files included for
  357. more detail.
  358.  
  359. SFCB.OK     Listing of numbers which do NOT need to be called.  This is useful
  360.             for skipping long-distance calls, and yet allowing validation.
  361.             Numbers are expected to be in the regular Spitfire format: eg 
  362.             519-455-4880.  The number is followed by a password.  If both the
  363.             phone number and passwords match, the user will be validated to
  364.             the security level given, and not the default ending security
  365.             level.
  366.             FORMAT:  ###-###-####,Password,Security
  367.             EXAMPLE:  519-455-4880,My123Pass,50
  368. SFCB.BAD    These numbers will NOT be called back either, but the security
  369.             level will not be raised to validated access.  The appropriate
  370.             message will be displayed.  NUMNOVAL.BBS/CLR should explain what
  371.             the user should do at this point.
  372.             FORMAT:  ###-###-####
  373. SFCB.XCH    This contains the local exchanges available from your area code. 
  374.             If you have all of the available local exchanges, you can then
  375.             prevent the prompt for long-distance callers when the caller is in
  376.             a local calling range.  (You can check the log file for any
  377.             exchanges you have missed, an exchange verified as local will
  378.             appear there.)
  379.             FORMAT:  ### (3-digit phone code)
  380. SFCB.LOG    If 'log file' is activated, this file will contain information on
  381.             the call-back process for each user, including failed attempts,
  382.             phone number changes (if permitted) times, dates, etc.
  383. SFCB.VAL    As a subset of SFCB.LOG this file contains only those users and
  384.             numbers that were validated.
  385. SFCB.NVL    Likewise, this file contains the users and numbers that failed
  386.             validation.
  387. SFCB.TRM    This is the customizable terminal file.  It contains the menu list
  388.             and the specific keywords to wait for upon reconnection.
  389.             FORMAT: OptionName,O, ,GENERIC.DAT
  390.             OptionName is the text to be displayed in the menu.  The 'O'
  391.             refers to the character used to select that option.  The string to
  392.             search for follows, (important: use a space if there is no special
  393.             character sequence to wait for) whatever is included in between
  394.             the commas must be sent by the remote program for SFCB to operate
  395.             correctly.  GENERIC.DAT refers to any special information needed
  396.             by the user to correctly operate SFCB with his/her terminal
  397.             program.
  398.             EXAMPLE: Mirror,M,Mirror,MIRROR.DAT
  399. SFCB.LST    Used to save information from the last caller to use SFCB so
  400.             he/she is not required to re-set the options and can try again
  401.             immediately.  If another user uses SFCB in between, this file will
  402.             not be used.
  403.  
  404.       Display files in SFCB follow the Spitfire convention.  Mono files
  405. (without colouring) have .BBS extensions and coloured (ANSI) files have .CLR
  406. extensions.  Here are the files that can be customized for your copy of SFCB:
  407.  
  408. Screen Name             Description                                     
  409. CBOPEN.BBS/CLR          Opening display - inform user of program purpose
  410. SETTINGS.BBS/CLR *      Current settings of call-back program
  411. MAINMENU.BBS/CLR        Displayed instead of the default main menu
  412. TERMINAL.BBS/CLR        Displayed instead of the default terminal menu
  413. CBHELP.BBS/CLR          Printed when the user asks for help.
  414. VERIFY.BBS/CLR          Displayed when caller is found in SFCB.OK
  415.                         (preverified)
  416. TIMEDAY.BBS/CLR         Cannot be validated at this time of day (local and
  417.                         long-distance callers)
  418. NUMNOVAL.BBS/CLR        Telephone number cannot be used for validation
  419. (SFCB.BAD)
  420. NODUPES.BBS/CLR         Telephone number is a duplicate (found in SFUSERS.DAT)
  421. NOQUALFY.BBS/CLR        Shown when a user is not qualified by reason of:
  422.                         duplicates, time of day, long-distance, not enough
  423.                         time, wrong security lever...
  424. CBNOLD.BBS/CLR          Show if a user is a long distance caller, and
  425.                         long-distance validation is disabled.
  426. CONNECT.BBS/CLR         Displayed prior before returning to BBS
  427.  
  428. In all cases, if there is no file available, a default line will be displayed.
  429. * In the absence of SETTINGS.BBS/CLR the valid times, and number of attempts
  430. will be shown.
  431.  
  432. WARNINGS
  433.  
  434.       Due to the nature of software and hardware, 100% compatibility is a goal
  435. but hardly a reality.  This program has been tested on a number of different
  436. computer systems, but this cannot guarantee that it will work with any
  437. specific (or your) setup and software/hardware combination.
  438.  
  439.       RainbowSoft Wares will be more than happy to provide assistance and fix
  440. errors, to a reasonable extent.  If you have any suggestions for improvement,
  441. or bug reports please feel free to report them.  (Refer to the locations noted
  442. at the beginning of the document.)
  443.  
  444. DISCLAIMER
  445.  
  446.       SFCB is distributed AS IS.  Neither Richard Sleegers, nor RainbowSoft
  447. Wares will be held responsible for direct or indirect damage to your computer
  448. (or its peripherals) or to  your sanity.  There are no warranties, expressed
  449. or implied, as to the operation or functionality of this program.
  450.       The primary goal of shareware is to provide quality programs at a low
  451. price to the purchaser.  If the program doesn't work for you, don't use it! 
  452. On the other hand, if it saves you time, and you leave it installed on your
  453. system, you should feel obligated to register it. Read on.
  454.  
  455. SHAREWARE INFORMATION
  456.  
  457.        SFCB is a Shareware program, distributed under the 'Try Before You Buy'
  458. concept; this means that after you have tried the program for a 'reasonable'
  459. length of time, (14 to 21 days) you must either register the program, or
  460. remove it from your system.
  461.        Registering this program grants you a limited license to use, for your
  462. personal use only, all files and documents contained in the original software
  463. package, distributed by RainbowSoft Wares.
  464.       Please see the file, SFCB.REG, for more information on registering this
  465. version of SFCB and what benefits arise from registering.
  466.  
  467. You are granted a limited license to distribute SFCB, subject to the following
  468. conditions:
  469.  
  470. 1.    You may not receive any financial compensation for direct access to this
  471.       program.  One exception is noted, whereby you may recover costs of
  472.       medium (Disk(ette)s, or other electronic medium) only, at a reasonable
  473.       amount.
  474. 2.    You may not alter any documents, programs, or files distributed with
  475.       SFCB.
  476. 3.    You may not mass-distribute SFCB without the written permission of
  477.       Richard Sleegers.  Distribution by electronic mail systems (or Bulletin
  478.       Board Systems) is permitted just in case condition 1 is met.
  479.  
  480. TRADEMARKS, COPYRIGHTS
  481.  
  482.       SFCB is copyright (c) 1992 by Richard Sleegers.
  483.  
  484.       SPITFIRE is a registered trademark of Buffalo Creek Software.
  485.       SPITFIRE is copyrighted 1986-1992 by Mike Woltz.
  486.  
  487.       Turbo Pascal is a registered trademark of Borland International, Inc.
  488.       Turbo Pascal is copyrighted 1983-1992 by Borland International, Inc.
  489.  
  490.       Portions of this program use source code provided by Mike Woltz and
  491. Buffalo Creek Software to allow file sharing.  BCSHARE may be downloaded from
  492. the BCS Bulletin Board at 515-225-8496
  493.  
  494.       Portions of this program are written with Object Professional and Async
  495. Professional under license. from  TurboPower Software.
  496.  
  497.       LzEXE is copyright 1989 Fabrice BELLARD.
  498.       PkLite (tm) is copyright 1992 PKWARE Inc.
  499.  
  500. SFCB HALL OF FAME!
  501.  
  502.       This section is dedicated to all those who helped in the production of
  503. SFCB.
  504.  
  505.       Thanks to all of the new users of RAINBOW BBS who have put up with me
  506. while I tried different (read unworkable) versions, usually made for different
  507. BBS's; or just plain had to WAIT while I worked on this program!
  508.  
  509.       Thanks to Tim Ingram of the Radio Station BBS who helped Beta test the
  510. original version and provided valuable suggestions and advice.  A golden globe
  511. goes to Bill Arlofski of the Reverse Polarity BBS for numerous suggestions
  512. prior to the release of version 1.2, and for testing on high speed modems. 
  513. Likewise, Derek Motloch of The Computer Room (TCR) who provided bug reports
  514. and suggestions, plus an HST modem to test the high-speed routines as well.
  515.  
  516. FUTURE MODIFICATIONS
  517.  
  518.       SFCB is always changing, as my needs for new user maintenance change. 
  519. This version reflects changes to long-distance validation, the addition of a
  520. number of configurable display files, repairs to the comm routines to work for
  521. a greater variety of modems, and some minor bug fixes.  I am open to other
  522. suggestions which you may have to improve or enhance SFCB.  You can contact me
  523. by mail or through Rainbow BBS.
  524.       One note of caution.  SFCB is not fool proof.  It is possible to
  525. circumvent the duplicate phone number scan, and the next version will
  526. eliminate this loophole.  For more information, contact me for temporary ways
  527. to prevent it.  (It involves using the SFCB.BAD text file)
  528.  
  529. MODIFICATION HISTORY
  530.  
  531. Version 1.00 Beta
  532.       Test version of SFCB
  533.       Limited chat mode, time lockout enabled
  534.  
  535. 1.1   Added Drop to DOS, enhanced chat mode (with word wrap)
  536.       Fixed time lockout (wouldn't work before 10:00 am)
  537.       Cosmetic changes to user interface.
  538.       Registration format - initial screen disable added.
  539.  
  540. 1.2   Enable 3.0 compatibility, Multi-node and file-sharing.
  541.       Will display Node Number in Log File (if activated)
  542.       Long-distance validation enabled.
  543.       Added CBNOLD.BBS/CLR to display if long-distance validation disabled.
  544.       SFCB now checks SFCB.BAD for phone numbers which will not be validated
  545.       (ie - local BBS numbers)
  546.       SFCB can instantly validate numbers included in SFCB.OK, and will
  547.       validate without call-back.
  548.       Repaired minor bug when coming back from Chat or Dos Jump, and
  549.       re-displays last line shown.
  550.       User phone number may now be changed "on the fly", if the sysop allows
  551.       it (set in configuration file).
  552.       SFCB.LOG will reflect changes to the phone number and incorrect phone
  553.       numbers, password, or name attempts.
  554.       SFCB.XCH now shows all available local exchanges that will not fit on
  555.       one line in SFCB.CFG.  The configuration file is read first and SFCB.XCH
  556.       is searched only if the prefix has not been found.  (So put frequently
  557.       used prefixes in SFCB.CFG and other local exchanges in SFCB.XCH)
  558.       SFCB.VAL contains the list of users who have been validated
  559.       SFCB.NVL will contain the list of users who failed validation
  560.       Added CONNECT.BBS/CLR to display once the user is reconnected
  561.       NUMNOVAL.BBS/CLR is displayed if the number is found in the SFCB.BAD
  562.       file.
  563.       NODUPES.BBS/CLR is displayed if the number is determined to be a
  564.       duplicate number.
  565.       NOQUALFY.BBS/CLR is displayed if the user cannot be validated for some
  566.       other reason.
  567. 4/20/91     Discovered intermittent timeout bug - fixed
  568. 4/21/91     Chat mode bug fixed
  569. 4/21/91     Line 20 of SFCB.CFG file caused the program to not continue
  570.             validation if set to FALSE - fixed to scan every number except the
  571.             users' number.
  572. 4/21/91     Made modifications to the dialing routine which would not work as
  573.             expected on some modems, and would not work at all on the 2nd and
  574.             3rd attempts.
  575.  
  576. *******Please note!  If you have a program which resets your BBS after x 
  577.       number of rings, please disable this  program before running SFCB!  Some
  578.       programs cannot properly distinguish rings and hangups so this may cause
  579.       reboots while attempting to redial.
  580.  
  581. 4/22/91     Added TIMEDAY.BBS/CLR to be displayed if the user cannot be
  582.             validated at that time of the day.  SFCB.CFG can now contain up to
  583.             10 different time zones for the day, in the format HH:MM-HH:MM
  584.             separated by a space, comma or semi-colon.
  585. 4/23/91     The configuration and door file could not be properly located,
  586.             this is fixed, as is the delay time prior to disconnected, to
  587.             allow the user to see the last few lines of text.
  588. 5/15/91     Fixed bug with duplicate numbers (if user is last on the user
  589.             list, which happens frequently with new users)
  590. 5/17/91     Created nicer scrolling routines with ANSI callers, cleaned up
  591.             some prompts, general code optimizing
  592. 5/31/91     Added support for special terminal programs, most notably, Mirror
  593.             II which does not allow incoming calls in terminal mode.
  594.             Call-backs may now be done for users already validated (with the
  595.             exception of long-distance calls) with changing security level.
  596. 8/1/91      SF 3.1 is now out.  SFCB is compatible with version 3.1 and 3.0 as
  597.             well.
  598. 8/15/91     Started work on an installation and configure program.  This will
  599.             do away with the SFCB.CFG file and SFCB will be self-contained.
  600. 8/23/91     Support for USR Courier and MicroCom high speed modems added,
  601.             easier to use user interface..
  602. 8/30/91     Prevalidated users are required to match the password in the
  603.             SFCB.OK file (if one is given) and will be validated to the given
  604.             security level.
  605.             -- hiatus --
  606. 2/14/92     USR / Courier modems now fully operational at all known speeds
  607. 2/27/92     Modem parameters made more flexible
  608.             Dial time out  - wait for CONNECT, etc signals
  609.             Redial time    - time between dialing
  610.             Reconnect time - time delay after reconnection to detect BBS'
  611.             better (improper phone numbers)
  612.             These options were also added to the SFCBINST install program.
  613. 3/ 1/92     Users no longer have to reenter their terminal information if
  614.             using SFCB twice in a row.  A text file SFCB.LST stores the
  615.             information on the last caller and is read in if it matches the
  616.             current user.   It is written when a user fails validation
  617.             (Usually through BUSY or NO CARRIER)
  618. 3/ 2/92     Install batch file spiffed up for much simpler install.
  619. 3/ 2/92     Added option to use a special access code upon reconnection, along
  620.             with name, password (and optional birthdate)
  621. 3/ 8/92     Clear buffer when returning from DOS (and not in chat mode)
  622. 3/ 3/92     1.2 Version finally released!!
  623.  
  624. COMMON QUESTIONS AND ANSWERS
  625.  
  626. Question:   What exactly does SFCB modify?
  627. Answer:     SFCB will modify the SFDOORS.DAT file (or SFMAIN.DAT, whichever
  628. file it finds) and the SFUSERS.DAT file.  Some older versions of SPITFIRE will
  629. only with if the door file is also modified, the user file is modified as a
  630. precaution.
  631.  
  632. Question:   What version of SPITFIRE does SFCB 1.2 work with?
  633. Answer:     SFCB is backwards compatible with version 2.8 and has been revised
  634. to work with version 3.1 on multitasking systems, with file sharing routines
  635. (Courtesy of BCS and Mike Woltz through the use of BCShare)
  636.  
  637. Question:   Why does SFCB ask for the user's name and password upon
  638. re-connection?
  639. Answer:     The answer to this question is obvious.  A user could leave the
  640. number of another Bulletin Board and be validated when it connects. Entering
  641. the name and password ensures that it is the same person that initiated the
  642. call-back.
  643.  
  644. Question:   What happens if a BBS system is called through SFCB?
  645. Answer:     The user will NOT be validated.  SFCB will never receive the
  646. user's name or password.  In your log file, you will notice some strange
  647. responses to the prompt for the user's name, and might be able to see what BBS
  648. system was called.  To prevent local Bulletin Boards from being called, lock
  649. out the numbers via the SFCB.BAD file.
  650.  
  651. Question:   Should I copy my SFDOORS.DAT file to the SFCB directory before
  652. calling SFCB?
  653. Answer:     Well this depends a lot on your preference and the type of system
  654. that you are running.  If you have a single node system, it is easiest to
  655. leave SFDOORS.DAT in the SPITFIRE directory and use the -D parameter to tell
  656. SFCB where it is.  If you copy SFDOORS.DAT to the SFCB directory, you _MUST_
  657. copy it back after the program is run because there is updated information in
  658. the door file after running the door.  On multi-node systems you may wish to
  659. copy the file to and from the SFCB directory to prevent collisions, if you are
  660. using the same SF directory for all nodes.
  661.  
  662. Question:   Once I'm registered, how to I get support?
  663. Answer:     You can call Rainbow BBS or write by mail (see title screen for
  664. details)  If you wish to pre-validate your account on Rainbow BBS, please
  665. include your number and unique password to use on Rainbow BBS with the
  666. registration form.  (Use SFCBINST.EXE to print out your registration form.)
  667.  
  668. Question:   I am having timeout problems with the call-back.  The modem will
  669. dial out but will not send a CONNECT or NO CARRIER signal to the modem, and
  670. then SFCB dials out again but immediately sends out a NO CARRIER.  This
  671. sometimes happens more than once.
  672. Answer:     You should change the contents of your modem's S7 register (on
  673. Hayes compatible modems)  This register controls the modem's internal wait
  674. time for reconnection.  SFCB is set for a dial timeout of 60 seconds, so if
  675. your S7 register is greater than 60 seconds, it will time out before the
  676. modem.  Change your register by using the ATS7=45 command (to set it to 45
  677. seconds for example)  Alternatively, you can store it in your NRAM (if one is
  678. available)  If your modem does not have an NRAM storage area, place the S7=45
  679. in your modem initialization string.  (In SPITFIRE, use the Alt-M command,
  680. option <I> at the ready for user prompt.  You may have to tweak this timeout
  681. with the SFCBINST program until you have a working program.  I suggest
  682. register S7 set to between 30 and 45, and timeout at 60.  NO CARRIER or BUSY
  683. will break the timeout, so it will not necessarily wait 60 seconds between
  684. each dial attempt.
  685.